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SUBROUTINE  IDENTIFICATION 

A.  Title:  Symbolic  Dump  Routine  (SYMDUMP)  -  Ident  A^8,  Mod  AB 

B.  Programmed  and  Docvimented:  ik  July  1962 

F.  J.  LaChapelle,  System  Development  Corporation 

C.  Revised:  14  February  1963 >  documented:  l4  March  1963 
R.  L.  Kinkead,  System  Development  Corporation 


PURPOSE 

To  provide  octal,  symbolic,  floating  point  decimal,  or  BCD  dumps  of  COPlI 
routines  using  their  names  to  define  the  areas  in  core  to  be  dumped. 


USAGE 

A.  Calling  Sequence 


L 

RTJ 

SiMDUMP 

L+1 

Normal  Retxxm 

ZRO 

N 

L+2 

BCD 

IXXXXXXXX 

L+3 

DEC 

T 

L+4 

BCD 

IPROGI 

L+5 

BCD 

1PR0G2 

L+K 

BCD 

IPROG(LAST) 

Where: 

N  =  the  total  number  of  parameters 

T  =  the  logical  tape  or  printer  to  write  dump  on  (2  <  T  <  13). 
PROGl  . . .  PROG(LAST)  =  the  names  of  the  specific  routines  to  dump 

(left  adjusted  with  trailing  blanks). 
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B.  The  Parameter  XXXXXXXX  is  optional  and  If  It  is  present,  the  result 
will  he  that  the  routines  will  he  dumped  in  the  specified  format.  The 
possible  values  of  XXXXXXXX  are; 

1.  SYMBOLIC  -  mnemonic  format 

2.  FLQATDBC  -  floating  point  decimal  format,  and 

3.  BCD  -  BCD  format. 

If  absent,  the  dump  will  be  in  octal. 

C.  When  called  by  a  function  card: 

*  SYMDUMP  XXXXXXXX  T  PROGl  . . .  PROG(liAST) 
where  all  parameters  are  defined  as  above  with  XXXXXXXX  again  optional. 

RESTRICTIONS 

A.  SYMDUMP  uses  the  TTTT  table,  LCOUHT,  LINFO,  and  LNAMES. 

B.  SYMDUMP  uses  the  subroutine  CORE,  (TM-(L)-715/016/001A)  . 

C.  A  page  eject  follows  the  dun^)  of  each  program  and  no  end  of  file  is 
written  following  a  dump. 

D.  A  maximum  of  twenty  routines  may  be  dumped  with  one*  call  to  SYMDUMP. 

E.  Only  those  routines  defined  previously  by  a  DEFINES  card  or  those 
routines  which  have  been  loaded  by  MTCII  at  executicn  time  may  be 
dumped  by  SYMDUMP. 

F.  It  is  possible  to  csdl  six  selected  areas  of  core  by  six  special  names. 
These  areas  and  their  mnemonics  are;  COMMON  (067i4-3g  -  07106g), 

POOL  (047OOg  -  07106g),  COP  (OOOOOg  -  077773  and  70000g  -  77777 q), 
ZEROTEN  (OOOOOg  -  OOOlOg),  INOUT  ( OOOOOg  -  077777q),  and  ALLCOP 
(OOOOOg  -  077773  and  70000g  -  777773)-  Note  that  COP  and  ALLCOP  are 
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the  sane  areas  and  consist  of  two  separate  parts.  INOUT  is  ewrythlng 
below  100000  since  the  l/o  routines  and  buffers  are  scattered  through¬ 
out  this  area. 

G.  If  a  routine  is  req.uested  which  is  not  a  special  name  or  has  not  been 
loaded  or  defined,  a  one-line  record  to  this  effect  is  written  on  the 
output  tape.  The  normal  dunqjing  of  the  remaining  routines  then  re¬ 
sumes  . 

H.  If  an  absolute  program  is  requested,  a  dump  beginning  with  the  first 
cell  of  the  program  and  extending  throu^  76^320  is  made. 

I.  If  the  logical  tape  is  illegal, a  normal  return  is  made  with  no  error 
message. 

J.  Output  is  called  into  core  by  CORE  using  the  ADDROF  feature  in  MTCII 
if  FLOATDEC  or  BCD  formats  sure  selected. 


TIMING 

SYMDUMP  takes  a  maximum  of  one  minute  to  dump  "32K"  core. 

STORAGE 

2330  cells  total. 

1210  cells  are  instruction  cells. 

15g  cells  for  a  table  defining  the  special  areas  of  core. 

25g  cells  contain  messages. 

150  cells  are  constants. 

33g  cells  are  temporary  storage. 

VALIDATION  TESTS 

SYMDUMP  was  tested  by  the  use  of  function  cards .  It  was  tested  for  dumping 
defined  routines,  routines  called  from  the  master  tape,  and  the  special 
areas  of  core  (in  all  of  the  possible  formats).  Tests  were  made  >rtiich 
printed  on  tape  and  the  on-line  printer.  Multiple  dumps  were  tested,  as 
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was  SYMDUMP's  response  to  illegal  tape  numbers  and  to  subroutines  not  in 
core. 

See  Appendix  A  for  the  function  card  inputs  and  the  dump  results  of  these 
tests . 

REFERENCES 

A.  "l6oit  Systems  Manual",  Lockheed  Missiles  and  Space  Division 
LMSC  -  44758,  1  January  I962,  P.  50.12.01. 

B.  Computer  Program  Library  Catalog  No.  75048. 
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GET  NAME  OF  NEXT 
ROUTINE  TO  BE 
DUMIED  FROM 
PARAMETERS 

1 

/  IS  THIS  \ 

(  ROUTINE  IN 

V  MEMORY  / 

1  YES 

SET  LENGTH  INFO 
FROM  LINFO  TABLE 
INTO  RANGE 

NO 

1 

SET  TW 
PART  F 
TO  NO 

0 

LAG 

NO 


IS  THIS 
A  SPECIAL 
NAME 


|^°.^/wORQn^ 


_ _ ^ 

,  YES 

SET  LENGTH  INFO 
FROM  THE  SRBCIAL 
TABLE  INTO  RANGE 

_ 5 

r 

IS  NAME 
COP 

OR  ALLCOP 
YES 


SET  TWO 
PART  FLAO 
TO  YES 


FIXIT 
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FIXIT 


COMPUTE  LIMITS 
FROM  INFO  IN 
RANGE 


EDIT  NAME,  START 
ADDRESS,  AND 
END  ADDRESS 
INTO  COMMENT 


SET  UPPER  AND 
LOVER  LIMITS 
INTO  LINKAGE 
FOR  CORE 


/  v«u;te  \ 

H OUTPUT  COMMENTN 
V  USING  MTCII  / 
\  I/O)  / 


RESET 

CONSOLE 

REGISTERS 


/  COEE 
(DUMP  THIS 
V  ROUTINE) 


SET  RANGE  FOR 
PART  TVO 


'  ARE  THERE 
TVO  PARTS  TO 
V  THIS  DUMP 


ISKDOIJ] 


SET  TWO 
PART  FLAG 
TO  NO 


,  FIXIT 
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S;IM  1ft  'TlLlTV  HASTER  c»uHJ7  HOU  IS  13  NAP  *3 
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1014*  77  7  77777  63  t  3675?  00  0  17777  77  7  77775  77  7  6525?  52  5  25746  00  0  0210*  21  0  26751 


DUMP  or  TH?  AlPHik  ROUTINE*  RANGE  IS  PHUM  10000  TO  lOlOO 
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10230  ?0  1  25424  26  0  0241)0  57  6  52353  51  7  75377  77  7  77777  77  7  77777  05  4  27102  77  5  75166 


$16»66474A464S2U  DOOBOnOOOOOOOOOO  00000  002^1  7ft432  00771  00000  00000 


OOOlO  ENl  3  00003  SIL  00003  ACT  3  00000  SLJ  00044  acT  3  00002  SEN  32000  ENI  1  07717  EN3  00000 


loaoo  232102(I113077»77  . 1(13<  957«4-17o  2701023320010245  - .  3735352H2«23t 
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THE  ROUTINE  NOSUCH  IS  NOT  IN  CORt  .  CHECK  TOUR  FUNCTION  CoRO  FOR  »H  ERROR 
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